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INTRODUCTION 


The APPLE II has a very flexible graphics mode called HIRES graphics. 
The HIRES screen, or page, consists of 53,768 dots organized as 28@ horizontal 
by 192 vertical. There are two of these pages available for use by the 
programmer. Apple Computer, Inc. developed a HIRES graphics package which plots 
points, draws lines and shapes but is not well suited to placing text 
information on these pages. The SCREEN MACHINE allows the user an easy and fast 
way to use the full compliment of TEXT commands to print on the HIRES pages. 


Now using HIRES graphics is as easy as printing in the TEXT mode. 


SYSTEM DESCRIPTION 


The Apple TEXT page has 480 characters per line and 24 lines per page. 
The SCREEN MACHINE duplicates this format on either HIRES page. Each character 
is 7 dots wide and 8 dots high for 40 characters and 24 lines. These characters 
are user definable, or programmable, for complete freedom to create the perfect 
symbols to fit your application. Ninty-six programmable characters, including 
32 lower case, make up one character set. A general purpose upper/lower case 
set is included to get you started! Character definition, editing and keyboard 
assignment are done with the BASIC Character Generator programs. Character sets 
are loaded or saved to disk or tape along with the assembly language driver 
routines in the form of Prefix programs. This Prefix can be appended, or 
attached, to your application program producing a single BASIC program using 
HIRES graphics and best of all NO COMPLICATED LOADING PROCEDURES!. Two versions 
of the character generator are Supplied. One is for INTEGER BASIC and the other 
supports ROM APPLESOFT. RAM APPLESOFT requires too much memory to support the 


SCREEN MACHINE Character generator but small applications programs can run with 
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RAM BASIC. Twenty-four 'K' of RAM is required for tape systems and thirty-six 
'K' for disk systems to run the Character Generator programs. Small application 
programs can run in sixteen 'K' using page one for display. The Apple HIRES 


Prefix is included with the system for a complete HIRES package. 


SOME CONVENTIONS 


To aid comprehension, we will establish a few conventions for the 
material contained in this document. All computer generated responses will be 
underscored, and should not be entered as part of a command. <CTRL R> refers to 
a single character generated from the keyboard. In this case the key marked 
"CTRL" is held down while the key "R" is pressed to generate the desired 
character. Material inside of apostrophes, ie. 'Hl', refer to names we have 
given to specific assembly language routines. They are usually used as BASIC 
variable names and the address of the subroutine is assigned to them, ie. 
H1=816. Now this subroutine may be executed with the BASIC "CALL" command, ie. 


CALL Hl, and is a lot more descriptive than CALL 816. 


The SCREEN MACHINE was designed for ease of use, but is just as easy to 
abuse! The few minutes spent reading this manual should provide the basic 


information necessary for successfully coding your own programs while avoiding 


frustrating misunderstandings. 
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SCREEN MACHINE PROGRAM DEVELOPMENT PROCESS 


There are three basic steps for using this product. 


1. A character set is designed and created with the 
Character generator program. It is saved in a prefix form on 


disk or tape to be used later. 


2. A BASIC program is written to use the defined character 
set. The development and testing of the program is done with 
the user character set resident in RAM. Any editing of the 
BASIC or character set is done at this point when the BASIC and 


character set are two Seperate entities. 


3. After the program has been debugged, the character set 
is appended (attached) to the BASIC program resulting in a 
Single BASIC load program ready to run on any Apple computer 


disk or tape based. 


The remainder or this section will guide you through your first 


programming effort using the SCREEN MACHINE. The examples will assume you are 


uSing a disk drive. If not, follow the tape proceedures outlined in the 


referenced sections of this manual. 


SAMPLE PROGRAM DEVELOPMENT 


1. 


26 


Read section three on using the Character. Generator. 


>LOAD and >RUN the INTEGER BASIC Character Generator. 
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3. Follow the instructions for defining characters and 
create the nine symbols pictured below. Assign each 


symbol to the keyboard character printed below each box. 


—------ OO000000 ------- O <- PLOT THIS POINT 
-----00 0000000 00----- 
----000 0000000 000---- - <- NO PLOT HERE 


--—O0000- ------- -—0000-- --O0000 -O0000- O0000-- 
---0000 ------- O0O0O0O0--- -- -—000- 00---00 -000--- 
----000 O-----O OO0O---- --- —00- OO000000 -00---- 
-----—00 0000000 OO0----- ---- -—00 OOOO0000 OO0----- 
------- OQOO0O0000 ------- ------- OQ0OO00000 ------- 
% & - / 
4. Save the character set with the <O> command. Call the file 


FACE when saving to the disk. 


5. Exit the character generator with the <X> command. 
6. At this point read sections four and five of the manual. 
7. Load and execute the character set (>RUN FACE). A 


*** BAD BRANCH ERR will be generated, ignore it. The 
Screen Machine and your set iS now in memory waiting for 
your beckon >CALL. 

8. Type CALL 816 to turn the Screen Machine on. Now you are 
typing in your character set on the Hires screen. 

9. When you are satified that your characters are intact, exit 
the Screen Machine by hitting <ESC> twice. You are now 


in TEXT mode and ready to enter your program. 
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10. Enter the following INTEGER BASIC program: 


9 H1=816 BY=846 
1@ CALL Hl 
106 V=RND(6)  H=RND(6)*6+1+(V MOD 2)*3 
110 V=vV*4+1 
120 VTAB V- TAB H_ PRINT "!#S" 
130 IF RND(2) THEN 150 
146 TAB H~ PRINT "%&'" GOTO 150 
15@ TAB H~ PRINT "-./" 
160 IF PEEK(-16384) < 128 THEN 166 


178 POKE -16368,6 CALL BY CALL -936 END 


ll. Save the program. Call it FACE.BAS 
12. Run the program. Line number 18 will turn the SCREEN MACHINE 
on and hitting any key will turn it off and exit the 
program. If the program runs correctly, continue to 
the next step. All editing should be done at this time. 
13. Read section six on appending the prefix to your program. 
14, Carefully follow the INTEGER BASIC append proceedure and 
attach the prefix (FACE) to the BASIC (FACE.BAS). 
Then save the finished program to disk. Call it THE 
GENERAL CONSENSUS. 
15. To run the program just type RUN THE GENERAL CONSENSUS. 
16. Remove the SCREEN MACHINE graph paper supplied at the 
end of this manual and make a lot of xerox copies. Get 
your imagination going and follow this genaral plan. Most 


of all have fun with the SCREEN MACHINE! 
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USING THE CHARACTER GENERATOR PROGRAM 


LOADING THE INTEGER BASIC CHARACTER GENERATOR 


For DISK IT Users: 36 k minimum 
l. Boot DISK II (refer to DISK II manual) 
2. >LOAD <RETURN> (from tape) 
3. DSAVE SCREEN MACHINE <RETURN> 
4. >RUN SCREEN MACHINE <RETURN> 


Once saved to disk steps 2 and 3 are ommitted. 


For Cassette Users: 24 k minimum 
1. <RESET> 
2. *<CTRL B> <RETURN> 
3. >LOAD <RETURND> 
4. >RUN <RETURN> 


LOADING THE ROM APPLESOFT CHARACTER GENERATOR 


For DISK II Users: 36 k minimum 
l. Boot DISK II 
2. >FP <RETURN> 
3. JLOAD <RETURN> 
4. SAVE SCREEN MACHINE.FP <RETURN> 
5. JRUN SCREEN MACHINE.FP <RETURN> 
For Cassette Users: 24 k minimum 
l. SET ROM SWITCH TO UP POSITION. 
2. <RESET> 
3. *<CTRL B> <RETURN> 
4. ]LOAD <RETURN> 


5. ]RUN <RETURN> 
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DEFINING CHARACTER SETS 


After loading and running the program you are ready to define your 
character set. The supplied set, displayed in the lower left of the screen, is 
a general purpose upper/lower case set. In the upper left corner is a seven by 
eight matrix used to define a character. Below is a list of commands used to 


define characters. DO NOT HIT RETURN AFTER ENTERING THEM. 


<Y> Plot a dot and advance cursor 
<N> Erase a dot and advance cursor 
<C> Erase cnaracter and home cursor 
<W> Cursor up 

<Z> Cursor down 

<A> Cursor left 

<S> Cursor right 


<RETURN> End definition mode and assign character. 


After the <RETURN> key has been pressed you will be asked if the 
character is correct. If not, type "no" then hit <RETURN> to start over. If 
correct just hit <RETURN>. You must then choose direct or hexadecimal keyboard 
assignment. For direct assignment just hit <RETURN>. The next selection is 
upper or lower case. For lower case type "yes" then <RETURN> and for upper case 
just hit <RETURN>. Now just touch the key you wish to assign your character to. 
Some characters are not available on the APPLE II keyboard so the hexadecimal 
assignment option is offered. To assign by hex code type "y" then <RETURN> when 
asked for assignment option. Then enter the row and column for the desired 
character. After character assignment the user set will be updated and you may 


define the next character. 
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EDITING CHARACTER SETS 


<E> Edit a previously defined charater 


This command allows you to edit a character from the user set (lower 
left). From the definition mode press <E> and select the desired character 
either directly or by hex code. The selected character will be displayed in the 
editing matrix and all cursor features are available to edit and reassign the 


character. 


SAVING AND LOADING CHARACTER SETS: 


<O> Output character set to disk or tape 


<I> Input character set from disk or tape 


To save your characters hit <O>. Now select disk or tape. For disk 
just hit <RETURN>. Then enter the filename to save it under. The filename must 
be less than thirty letters and start with an alphabetic character. To save to 
tape enter "T" then <RETURN>. Start the tape recorder in the proper mode then 
hit <RETURN> again. After the system returns to definition mode, you may stop 


the tape. Loading a character set follows the same procedure described above. 


NOTE: IF A DISK OR TAPE ERROR OCCURS DURING A LOAD OR SAVE THE PRQGRAM WILL BE 
LOST!! YOU MAY RECOVER IT WITH YOUR CHARACTERS INTACT BY CAREFULLY FOLLOWING 


THE RESTART PROCEEDURES. IF YOU RELOAD, YOUR CHARACTERS WILL BE LOST FOREVER! 


SECTION THREE 


INTEGER BASIC RESTART 


1. 


2e 


O200 - XX YY 


3. 


4. 


<RESET> 


*8.1 <RETURN> 


*CA: XX YY <RETURN> (XX YY FROM LAST STEP) 
*3D0G <RETURN> (FOR DISK USERS) 

-OR- 

*<CTRL C> <RETURN> (FOR TAPE USERS) 


>RUN <RETURN> 


ROM APPLESOFT RESTART 


SET ROM CARD SWITCH TO UP POSITION 


<RESET> 

*3D8G <RETURN> (FOR DISK USERS) 
-OR- 

*<CTRL C> <RETURN> (FOR TAPE USERS) 


]RUN <RETURN> 


EXITING THE CHARACTER GENERATOR PROGRAM: 


<X> 


To exit just hit <X>. 


Exit the program and return to BASIC 
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Do not use <CTRL C> to exit as this will leave 


the system under control of the SCREEN MACHINE with the disk operating system 


deactivated. 
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THE SCREEN MACHINE PREFIX 


The user defined character set and Screen Machine drivers are saved by 
the character generator program in a prefix form ready to be appended (attached) 
to the user's BASIC program. It may also be directly executed for program 
testing and development. The files created by the INTEGER BASIC and ROM 
APPLESOFT BASIC versions are quite different in form and will be discussed 
seperately. Their purpose however is functionally identical. This is what a 


SCREEN MACHINE prefix is designed to do: 


l. Move the machine language drivers and character data 
tables to a free area of memory for execution. 

2. Reset the BASIC variable pointers to protect the subroutines 
from being crashed by BASIC variable storage. 

3. Attach to the user's Basic program to provide a single 


BASIC load program. 


The following material examines in detatl what happens when a prefix is 
executed. It also provides the proceedures for directly executing a prefix. 


Refer to section six for information on appending the prefix to your program. 


THE INTEGER BASIC SCREEN MACHINE PREFIX 


The file created by the INTEGER BASIC character generator is stored in 
the form of an INTEGER BASIC program. It is loaded with the >LOAD command and 
*<ecuted with the >RUN command. When executed the subroutines are seperated 


from the BASIC and moved to low memory. LOMEM is set above them. 


SECTION FOUR 


HEX LOCATION 


338 3AF 
800 BFF 
COO FFF 
1008 - l2FF 


OCCUPIED WITH 
SCREEN MACHINE entry points. 
SCREEN MACHINE object code. 
One "k" of BASIC variable storage. 
SCREEN MACHINE character data. 


LOMEM will be set at 3872 (SC0®). 
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The prefix then links to the uSer program by reseting the BASIC program 


pointers to the beginning of the user program and executing a GOTO @. When 


directly executed there will be no user program to link to so a *** BAD BRANCH 


ERR will result. Whether the prefix was appended or not, after execution the 


SCREEN MACHINE and uSer character set are available for use. 


on functions and commands) 


THE ROM APPLESOFT SCREEN MACHINE PREFIX 


(see section five 


The file created by the APPLESOFT character generator is stored as a 


binary file. It is loaded with the BLOAD disk command or monitor tape read 


Subroutine. It is executed by CALLing it from BASIC. 


DIRECTLY EXECUTING THE APPLESOFT PREFIX 


DISK SYSTEMS 


& W N e 
e e e e 
— ed — V 


ui 
r 
— 


> FP <RETURN> 


] CALL 979 <RETURN> 


J CALL 8192 <RETURN> 


] BLOAD (PREFIX NAME) , A8192 <RETURN> 


] NEW <RETURN> 


(IF NOT IS FP BASIC) 


(IF STEP ONE WAS OMMITED) 


(IGNORE SYNTAX ERROR) 
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TAPE SYSTEMS 


1. SET ROM SWITCH TO UP POSITION. 

2. <RESET> 

3. * <CTRL B> <RETURN> 

4. ] POKE 68,8 POKE 61, 32 POKE 62,0 POKE 63,41 


CALL -259 (START TAPE BEFORE HITTING RETURN) <RETURN> 
5. ] CALL 8192 <RETURN> (IGNORE SYNTAX ERR) 


6. ] NEW <RETURN> 


A syntax err will be generated by the CALL 8192 statement. This happens 
because the keyboard RAM buffer ($200 - 2FF) is used in the relocation process 
described below. The contents of this buffer (the CALL statement) are destroyed 
in this process and APPLESOFT generates an err trying to parse the buffer. This 
err will not occur when the prefix is attached to the APPLESOFT BASIC program. 

When executed, the prefix locates HIMEM, relocates the Screen Machine to 
run there and then moves it there. It then reallocates the Space it previously 
occupied to APPLESOFT for variable storage. HIMEM is then set to below the 
Screen Machine to protect it. The user can control where the Screen Machine 
lives by setting HIMEM before calling the relocator (] CALL 8192). This 
proceedure is recommended for two reasons. 

1. It allows for reserving space for user routines and data. 

2. It prevents the relocator from cascading HIMEM down. 

If a prefix was executed five times consecutively, there would be five unique 
Screen Machines in memory! This is avoided by setting HIMEM or cold starting 
APPLESOFT (] CALL 979 for disk or <RESET> <CTRL B> for tape) before loading and 
executing a prefix. The Screen Machine occupies 1 3/4 "k" and sets HIMEM 


correspondingly lower after relocation. 
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SCREEN MACHINE FUNCTIONS AND COMMANDS 


TURNING THE SCREEN MACHINE ON 
Once the Prefix has been run the system is initialized by calling one of 
the following routines. 
'H1' CALL 816 JSR $33¢ 
Initial user entry point for page one display. Sets all default 
parameters, clears HIRES page and homes cursor. Does not change 
current window size. Disables the disk operating system. 
"H2' CALL 823 JSR $337 


The same as 'H1' but uses HIRES page two for display. 


TURNING THE SCREEN MACHINE OFF 
Gracefully exiting the SCREEN MACHINE and returning to TEXT mode and the 
disk operating system can be done in two ways. 
"BY' CALL 846 JSR $34E 
This call is used inside of a program to exit the system. 


From command mode hitting <ESC> twice exits the system. 


DEFAULT PARAMETERS FOR ‘HR1’ AND ‘HR2’ COMMANDS 


*NM' White characters on black background. 
<CTRL R> Upper case operation. 
‘ES ' Scroll feature enabled. 


Background color set to Blackl. 

The source page is the destination page. 
‘SM' The characters are ‘Stored’ on the screen 

replacing the previous character at that 


position. 
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SCREEN FUNCTION ENTRY POINTS: 


The following calls are direct replacements for APPLE II monitor calls. 


Some of the functions are executable from command mode by using standard escape 


sequences. 


"HM! 


'pp! 


‘EL? 


On-screen editing is Supported also. 


CALL 897 JSR $381 (ESC @) 
Clear current text window to background color and home cursor. 
This replaces CALL -936 in function. 
CALL 891 JSR $37B (ESC F) 
Clear from cursor to end of page with background color. Cursor 
position is unaffected. This replaces CALL -958 in function. 
CALL 885 JSR $375 (ESC B) 
Clear from cursor to end of line with background color. Cursor 
position is unaffected. This replaces CALL -868 in function. 
CALL 963 JSR $387 
Scroll the current window up one line. This replaces CALL -912 


in function. 


POKE 789 , BKGD COLOR Set background color value 


MY) Blackl 

1 Green 

2 Violet 

3 Whitel 

4 * Black2 * These colors are 
5 * Orange available on new 
6 * Blue or modified 

7 * White2 APPLE II's only! 


All of the above screen functions operate within the TEXT window defined 


in location 32-35 ($20-23). See APPLE II REFERENCE MANUAL for information about 


setting the text window. 
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UPPER/LOWER CASE SELECTION 

Two control characters are assigned the function of case selection. 
They may be imbedded in BASIC print strings for case control. To generate a 
control character hold down the control key and press desired character. 

<CTRL R> Selects upper case for following characters. 

<CTRL S> Selects lower case for following characters. 
NOTE: Control characters are not held in screen memory. When using the on 
screen editing feature of the APPLE II, case control characters must be 


reinserted into print strings. 


AUXILIARY FUNCTIONS 

‘IN' CALL 931 JSR $3A3 
Set inverse mode for black characters against white. When 
background is set to white this produces a totally inversed 
screen. 

'NM' CALL 935 JSR $3A7 
Restores normal mode for white characters against black. 

‘NS ' CALL 869 JSR $365 
Disables scrolling feature. 

‘ES ' CALL 873 JSR $369 
Restores normal scrolling operation. 

"CHRSFNC' - POKE 768,ASCII CALL 879 
This is similar to the CHRS$ function of most extended BASICs. It 
allows you to force any decimal ASCII value to the output driver. 
It permits printing characters not available on the keyboard. 

‘CD' CALL 846 JSR $348 
After calling 'BY' this will reinitialize the system without 


clearing the HIRES screen. It does set default parameters. 


SECTION FIVE 


PAGE 16 


CALL 843 JSR $34B 


This is the same as 'CD' but does not reset default parameters 


ADVANCED OUTPUT DRIVER OPTIONS 


The following options afford the experienced programmer greater 


flexibilty for animations and composite character contructions. It is 


recommended that they be avoided in command mode. The novice should review the 


logical operations “AND, OR and EXCLUSIVE OR" before attempting to use these 


options. References to screen memory indicate the data at the current cursor 


position on the referenced screen. 


a 4) 


"OM! 


CALL 989 JSR $38D 
Output is directly stored on the destination page replacing 
previous data. This is the normal mode of operation. 

CALL 916 JSR $394 
Output is EXCLUSIVE OR'ED with the source page and stored on the 
destination page. This mode is useful for non-destructive 
character animations. 

CALL 929 JSR $398 
Output is OR'ED with the source page and stored on the 
destination page. This mode is most useful for composite 
character contructions. 

CALL 912 JSR $390 
Output is AND'ED with the source page and stored on the 
destination page. This is useful for masking with colors on the 


alternate page. 
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‘Fl’ CALL 849 JSR $351 
Select page one as the source page. 

‘F2' CALL 853 - JSR $355 
Select page two as the source page. 

‘Tl’ CALL 859 JSR $35B 
Select page one as destination page. 

'T2! CALL 863 JSR $35F 


Select page two as destination page. 


When the system is initialized the destination page is the same as the 
source page. The 'IN' command performs a logical NOT on the character data 


before the output options are exercised. 
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APPENDING THE SCREEN MACHINE PREFIX 


The append proceedures outlined below takes two programs and combines 
them into one. The term "PREFIX" refers to your character set as defined and 
saved by the Character Generator program. The term "USER PROGRAM" is the 
applications program which uses the programmable characters. After your program 
is debugged, follow these steps to attach it to your character set. Then you 


will have one BASIC program which is easy to run. 


INTEGER BASIC APPEND PROCEDURE 


1. <RESET> 

2. *3D3G <RETURN> (FOR DISK USERS) 
-OR- 
*<CTRL B> <RETURN> (FOR TAPE USERS) 

3. >LOAD (FILENAME) <RETURN> (LOAD USER PROGRAM) 

4. DHL=PEEK (76) <RETURN> 

5. >HH=PEEK (77) <RETURN> 

6. >POKE 76, PEEK(2@2) <RETURN> 

7. >POKE 77, PEEK (2863) <RETURN> 

8. >LOAD (FILENAME) <RETURN> (LOAD PREFIX PROGRAM) 

9. >POKE 76, HL <RETURN> 

1d. >POKE 77, HH <RETURN> 

li. >SAVE (FILENAME) <RETURN> (SAVE TOTAL PROGRAM) 


When appending the INTEGER BASIC Prefix, the user program must start 
with line number zero. You cannot edit the program after it has been appended 
So make sure all of the bugs are out before doing so. When appending the APPLE 


HIRES Prefix, first append it to the user program then append the character set 
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to the total. The last program appended is the first executed. The HIRES 
Prefix must be executed after the SCREEN MACHINE Prefix. 

If you are using a disk system you can debug your program by appending 
the prefix to this simple program. You cannot edit a prefix after it has been 
appended so keep a pure copy. 


®@ PRINT "<CTRL D> RUN (USER PROGRAM NAME) END 


ROM APPLESOFT APPEND PROCEDURE 


Disk users 


1. Boot DISK II 

2. >FP <RETURN> 

3. JLOAD USER PROGRAM <RETURN> 

4. JPRINT "<CTRL D> BLOAD PREFIXNAME ,A"; PEEK(175) + 


256 * PEEK (176) <RETURN> 
5. JPOKE 176, PEEK(176) + 9 <RETURN> 


6. JSAVE APPENDED PROGRAM <RETURN> 


1. SET ROM SWITCH TO UP POSITION 

2. <RESET> 

3. *<CTRL B> <RETURN> 

4. ]LOAD <RETURN> (USER PROGRAM) 


(GET PREFIX ON TAPE READY TO BE LOADED BY STEP #5) 
5. JPOKE 68, PEEK(175) POKE 61, PEEK(176) POKE 62, PEEK (68) 
POKE 63, PEEK(61) + 9 CALL -259 <RETURN> 
6. JPOKE 176, PEEK(176) + 9 <RETURN> 


7. JSAVE <RETURN> (TOTAL PROGRAM) 
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When appending the APPLESOFT Prefix the uSer program must Start with the 
following lines: 

1 IF PEEK(175) + 256*PEEK (176) <> PEEK(185) + 256*PEEK (106) THEN GOTO 4 

2 HIMEM: 32767 ( USER SELECTABLE ) 

3 CALL PEEK (175) + 256* (PEEK (176) - 9) 

4 REM USER PROGRAM STARTS HERE 

Line 1 Checks to see if the prefix has been previously run. 

If so, the next two lines are skipped and the user program is 
executed at line 4. Never modify an appended APPLESOFT 
program after it has been run. Any change made to the 
program will reset the flags set by the relocator and 

line 1 will determine that the prefix has not been executed 
when in fact it was. Your program will bomb if JRUN in 

this state. 

Line 2 Sets the highest memory location available to the SCREEN 
MACHINE. Never put HIMEM at a location which will conflict 
with the Hires screen you wish to use. 

Line 3 This calls the SCREEN MACHINE relocator which relocates, 
and moves the SCREEN MACHINE to high memory. It then 
resets HIMEM, and releases the space used for the prefix 
to APPLESOFT for variable storage. This statement must 
only be executed once! 

Line 4 This line marks the start of the user program. BASIC 


variables must not be defined prior to this line. 


Unlike the INTEGER BASIC prefix, an APPLESOFT program may be edited 
after it has been appended. There are some restrictions however. Always edit a 
appended program and save it before you run it. After you run it, the prefix is 


deleted so always save the edited version before you run it. 
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USING THE APPLE HIRES PREFIX 


The SCREEN MACHINE offers a convenient way to display user defined 
characters and symbols on the HIRES screen. It cannot plot curves or draw lines 
from one point to another. It also will not allow a shape to be placed off of a 
character boundary. For these purposes a special package has been developed by 
APPLE COMPUTER, INC. This package is included as the HIRES PREFIX program and 
is distributed with the SCREEN MACHINE under license agreement with APPLE 


COMPUTER, INC. 


LOADING THE HIRES PREFIX 


Loading the HIRES PREFIX is exactly the same a loading a SCREEN MACHINE 
PREFIX. It is an INTEGER BASIC load (or RUN with disk systems) and running it 
places the HIRES routines in memory and sets LOMEM to protect them. They were 
intended to append to a user program and thus the term PREFIX is used. See 
section section six for append procedure. 


Note: The HIRES Prefix must be RUN AFTER the SCREEN MACHINE Prefix. 


HIRES PREFIX ENTRY POINTS 


These entry points are used exactly like SCREEN MACHINE entry points. 


The CALL values are assigned to variable names and then the variables are 


CALLed. 

"HPG1' CALL 3798 use page one for display 
"HPG2' CALL 3794 use page two for display 
"POSN'! CALL 3833 position a X,Y point 
"PLOT! CALL 3854 plot a X0,Y@ point 


"LINE' CALL 3860 draw a line to X@,YO 
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*DRAW' CALL 3895 draw a Shape 
"XDRAW'! CALL 3988 EXCLUSIVE-OR a shape 
*SHLOAD ' CALL 4825 LOAD a shape table 


INITIALIZATION 

The first line number of any program using the HIRES PREFIX must be: 

9 X@=Y0=COLR=SHAPE=ROT=SCALE 

This is very literal. The line number must be zero, the variable names 
must be as shown and in the order given. Parameters are passed through these 


variables to the assembly language routines. 


Now set up the equates for the SCREEN MACHINE and the APPLE HIRES. 
10 H1=816 HM=897 etc..... 


20 HPG1=3790 PLOT=3854 etc..... 


Before using any function you must initialize the SCREEN MACHINE and the 
APPLE HIRES. 
5@ CALL Hl CALL HPG1 REM FOR PAGE ONE DISPLAY 


5@ CALL H2 CALL HPG2 REM FOR PAGE TWO DISPLAY 


PLOTTING, DRAWING LINES AND SHAPES 
To plot a point on the screen you could write: 
18@ COLR=n (where n is @ - 7) 
110 X9=x (where x is 9 - 279 horizontal position) 
128 YO=y (where y is @ - 191 vertical position) 
138 CALL PLOT (plot the point at X8,Y@ with COLR) 


148 END 
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To draw a line from that point to another point make this addition: 
149 X@=x' (x' is new horiz. position) 

158 Y@=y' (y' is new vertical position) 

168 CALL LINE (draw a line between x,y and x',y') 


178 END 


The 'POSN' is the same as the 'PLOT' but no point is actually plotted. 


It is seldom used. 


Using the 'DRAW' or 'XDRAW' fuctions requires the presence of a shape 
vector table which is complex in nature and will not be described in this 
manual. The reader is referred to pages 92 to 180 of the APPLESOFT II reference 


manual for this information. Here is a brief description of the shape routines. 


*SHLOAD' Load a standard APPLE shape table and 


set LOMEM to protect it 


SHA PE=n n is the desired shape number 

ROT=n n is the rotation value @ - 63 

SCALE=n n is the size of the shape 

*DRAW' Draw the shape at X8,Y@ with COLR 

"XDRAW' Exclusive-OR the shape with the screen 
at X@,YO 


The shape table starts at $1388 and LOMEM must be set above it. 
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QUICK INDEX OF ENTRY POINTS 


SCREEN MACHINE ENTRY POINTS: (SEE SECTION FIVE FOR DETAILS) 


"HI! CALL 816 JSR $330 

'H2! CALL 823 JSR $337 

‘BY! CALL 846 JSR $34E (ESC ESC) 
‘HM’ CALL 897 JSR $381 (ESC @) 
"EP! CALL 891 JSR $37B (ESC F) 
"BL! CALL 885 JSR $375 (ESC B) 
‘Sc! CALL 9683 JSR $387 

"IN! CALL 931 JSR $3A3 

‘NM! CALL 935 JSR $3A7 

'NS' CALL 869 JSR $365 

"ES! CALL 873 JSR $369 

'CD! CALL 8498 JSR $348 

"wM' CALL 843 JSR $34B 

"SM! CALL 989 JSR $38D 

"XM! CALL 916 JSR $394 

Te) CALL 920 JSR $398 

"AM! CALL 912 JSR $390 

"Fl! CALL 849 JSR $351 

'F2' CALL 853 JSR $355 

'Tl' CALL 859 JSR $35B 

'T2! CALL 863 JSR $35F 

<CTRL R> SET UPPER CASE MODE 

<CTRL S> SET LOWER CASE MODE 

"CHRSFNC ! POKE 7658,ASCII : CALL 879 


APPLE HIRES PREFIX ENTRY POINTS: : (SEE SECTION SEVEN FOR DETAILS) 


‘HPG1' CALL 3798 
"HPG2' CALL 3794 
"POSN! CALL 3833 
"PLOT ' CALL 3854 
"LINE ' CALL 3860 
*DRAW' CALL 3895 
"XDRAW' CALL 3988 
"SHLOAD' CALL 4025 


LINE ZERO MUST BE: @ X8=Y0=COLR=SHA PE=ROT=SCALE 


(SOFTEE 
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